home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / dev / misc / LEDA_high.lha / LEDA-3.1c-high / man / panel.tex < prev    next >
Encoding:
Text File  |  1994-08-05  |  2.8 KB  |  74 lines
  1. \bigskip
  2. {\magonebf  6.8 Panels (panel)}
  3.  
  4. \def\name{panel}
  5.  
  6. {\bf 1. Definition}
  7.  
  8. Panels are windows used for displaying text messages and updating the 
  9. values of variables. A panel $P$ consists of a set of panel items and a set 
  10. of buttons. With each item (except of text items) is associated a variable of 
  11. a certain type (int, bool, string, double, color) whose value can be
  12. manipulated through the item and a string label.
  13.  
  14. \bigskip
  15. {\bf 2. Creation}
  16.  
  17. \create  P  (string\ h)
  18.  
  19. creates an empty panel $P$ with header $h$.
  20.  
  21.  
  22. \bigskip
  23. {\bf 3. Operations}
  24. \medskip
  25. \+\cleartabs &\hskip 1.3truecm &\hskip 4.3truecm &\cr
  26. \smallskip
  27. \+\op void   text\_item {string\ s}
  28.                   {adds a text\_item $s$ to $P$.}
  29. \smallskip
  30. \+\op void   bool\_item {string\ s,\ bool\&\ x} {}
  31. \+\nop            {adds a boolean item with label $s$ and variable $x$ to $P$.}
  32. \smallskip
  33. \+\op void   real\_item {string\ s,\ doubel\&\ x} {}
  34. \+\nop            {adds a real item with label $s$ and variable $x$ to $P$.}
  35. \smallskip
  36. \+\op void   color\_item {string\ s,\ color\&\ x} {}
  37. \+\nop            {adds a color item with label $s$ and variable $x$ to $P$.}
  38. \smallskip
  39. \+\op void   int\_item {string\ s,\ int\&\ x} {}
  40. \+\nop            {adds an integer item with label $s$ and variable $x$ to $P$.}
  41. \smallskip
  42. \+\op void   int\_item {string\ s,\ int\&\ x,\ int\ min,\ int\ max} {}
  43. \+\nop           {adds an integer slider item with label $s$, variable $x$, and}
  44. \+\nop           {range $min$,\dots,$max$ to $P$.}
  45. \smallskip
  46. \+\op void   int\_item {string\ s,\ int\&\ x,\ int\ low,\ int\ high,\ int\ step} {}
  47. \+\nop            {adds an integer choice item with label $s$, variable $x$,}
  48. \+\nop            {range $low$,\dots, $high$, and step size $step$ to $P$.}
  49. \smallskip
  50. \+\op void   string\_item {string\ s,\ string\&\ x} {}
  51. \+\nop            {adds a string item with label $s$ and variable $x$ to $P$.}
  52. \smallskip
  53. \+\op void   string\_item {string\ s,\ string\&\ x,list\<string\>\ L} {}
  54. \+\nop           {adds a string item with label $s$, variable $x$, and menu $L$}
  55. \+\nop           {to $P$.}
  56. \smallskip
  57. \+\op void   choice\_item {string\ s,\ int\&\ x,\ list\<string\>\ L} {}
  58. \+\nop          {adds an integer item with label $s$, variable $x$, and choices}
  59. \+\nop          {from $L$ to $P$}
  60. \smallskip
  61. \+\op void   choice\_item {string\ s,\ int\&\ x,\ string s_1,\ string\ s_2, \dots, s_k} {}
  62. \+\nop          {adds an integer item with label $s$, variable $x$, and choices}
  63. \+\nop          {$s_1$, \dots, $s_k$ to $P$ ($k \le 5$)}
  64. \smallskip
  65. \+\op int   button {string\ s}
  66.                   {adds a button with label $s$ to $P$ and returns its number}
  67. \smallskip
  68. \+\op void   new\_button\_line {}
  69.                   {starts a new line of buttons}
  70. \smallskip
  71. \+\op int    open {} 
  72.                   {$P$ is displayed on the screen until a button of $P$ is}
  73. \+\nop            {selected. Returns the number of the button.}
  74.